类 FoxitPDFSDKPython3.PDFNameTree 继承关系图:

Public 成员函数
def	PDFNameTree (document, type)
	带参数的构造函数。更多...

def	PDFNameTree ()
	构造函数。

def	PDFNameTree (other)
	拷贝构造函数。更多...

def	Add (name, pdf_object)
	添加一个新的键名及其PDF对象作为值。更多...

def	GetCount ()
	获取当前名称树中元素的数量。更多...

def	GetName (index)
	通过索引获取名称树中的键名。更多...

def	GetObj (name)
	获取指定键名的值(作为PDF对象)。更多...

def	GetType ()
	获取当前名称树的类型。更多...

def	HasName (name)
	检查指定的键名是否存在于当前名称树中。更多...

def	IsEmpty ()
	检查当前对象是否为空。更多...

def	RemoveAllObjs ()
	从当前名称树中删除所有键名及其值(作为PDF对象)。更多...

def	RemoveObj (name)
	从当前名称树中删除一个键名及其值(作为PDF对象)。更多...

def	Rename (old_name, new_name)
	将现有键名重命名为新键名。更多...

def	SetObj (name, pdf_object)
	设置指定键名的值(作为PDF对象)。更多...

静态 Public 属性
	e_Dests = _fsdk.PDFNameTree_e_Dests
	"Dests"名称树。

	e_EmbeddedFiles = _fsdk.PDFNameTree_e_EmbeddedFiles
	"EmbeddedFiles"名称树。

	e_JavaScript = _fsdk.PDFNameTree_e_JavaScript
	"JavaScript"名称树。

	e_Pages = _fsdk.PDFNameTree_e_Pages
	"Pages"名称树。

	e_Templates = _fsdk.PDFNameTree_e_Templates
	"Templates"名称树。

详细描述

名称树是PDF中的一种常见数据结构。名称树与PDF字典的目的相似

关联键和值 - 但通过不同的方式：在名称树中,键名被视为其值对象的别名。这意味着,可以通过键名而不是通过引用对象来引用值对象。
名称树具有以下特点:
- 名称树中的键名是有序的,同一名称树中的每个键名都是唯一的;
- 与键名关联的值可以是任何类型的对象,具体取决于名称树的用途;
- 名称树可以表示任意大的键值对集合,可以高效查找而无需从PDF文件中读取整个数据结构。
类PDFNameTree 用于与指定类型的现有名称树关联或创建一个。它提供了在名称树中获取键值对以及设置/添加/删除任何键值对的函数。目前,类PDFNameTree 可以与PDF文档中定义的以下名称树关联:
- 目标名称树(类型为FoxitPDFSDKPython3.PDFNameTree.e_Dests ), 将名称字符串映射到目标。此名称树中的值应该是目标数组 (或对目标数组的引用对象)。
- JavaScript名称树(类型为FoxitPDFSDKPython3.PDFNameTree.e_JavaScript ), 将名称字符串映射到文档级JavaScript操作。此名称树中的值应该是 JavaScript操作字典(或对JavaScript操作字典的引用对象)。
- 嵌入文件名称树,类型为FoxitPDFSDKPython3.PDFNameTree.e_EmbeddedFiles ,将名称字符串映射到嵌入文件流的文件规范。此名称树中的值应该是文件规范字典(或对文件规范字典的引用对象), 其中包含嵌入文件流。
- 页面名称树,类型为FoxitPDFSDKPython3.PDFNameTree.e_Pages ,将名称字符串映射到页面。此名称树中的值应该是对页面字典的引用对象。
- 模板名称树,类型为FoxitPDFSDKPython3.PDFNameTree.e_Templates ,将名称字符串映射到隐藏页面。此名称树中的值应该是对隐藏页面字典的引用对象。请使用函数FoxitPDFSDKPython3.PDFDoc.HidePageTemplate 来隐藏页面。
为了方便使用PDF文档中的嵌入文件(也称为附件), 请参考类FoxitPDFSDKPython3.Attachments 。

参见: FoxitPDFSDKPython3.Attachments

构造及析构函数说明

◆ PDFNameTree() [1/2]

def FoxitPDFSDKPython3.PDFNameTree.PDFNameTree	(	document,
		type
	)

带参数的构造函数。

如果PDF文档中存在指定类型的名称树, 此函数只是构造一个PDF名称树对象以与该名称树关联。如果PDF文档中没有此类名称树,则可以使用构造的PDF名称树对象在PDF文档中创建此类名称树并向名称树添加项。

参数

[in]	document	有效的PDF文档对象。
[in]	type	名称树的类型。请参考从FoxitPDFSDKPython3.PDFNameTree.e_Dests 开始的值, 这应该是这些值中的一个。

◆ PDFNameTree() [2/2]

def FoxitPDFSDKPython3.PDFNameTree.PDFNameTree ( other )

拷贝构造函数。

参数

[in] other 另一个PDF名称树对象。

成员函数说明

◆ Add()

def FoxitPDFSDKPython3.PDFNameTree.Add	(	name,
		pdf_object
	)

添加一个新的键名及其PDF对象作为值。

名称树中的所有PDF对象都按其名称排序。添加新的PDF对象时, Foxit PDF SDK将在名称树中找到合适的位置来添加它。成功添加后, 一些旧键的索引可能会改变。

参数

[in]	name	新键名的字符串。这不应该是空字符串。此新名称不应该已存在于当前名称树中。
[in]	pdf_object	要使用新名称设置的PDF对象。此PDF对象的类型应该与当前名称树匹配;否则,输入的PDF对象无效。请参考类PDFNameTree 的注释以获取更多详细信息。此函数成功后,用户不应释放此PDF对象。

返回: true表示成功,而false表示失败。

◆ GetCount()

def FoxitPDFSDKPython3.PDFNameTree.GetCount ( )

获取当前名称树中元素的数量。

返回: 元素数量。

◆ GetName()

def FoxitPDFSDKPython3.PDFNameTree.GetName ( index )

通过索引获取名称树中的键名。

参数

[in] index 要检索的键名的索引。有效范围:从0到(count-1)。 count由函数FoxitPDFSDKPython3.PDFNameTree.GetCount 返回。

返回: 表示键名的字符串。

◆ GetObj()

def FoxitPDFSDKPython3.PDFNameTree.GetObj ( name )

获取指定键名的值(作为PDF对象)。

参数

[in] name 键名的字符串。它不应该是空字符串。

返回: 一个PDFObject 对象。返回的PDF对象的类型取决于当前名称树的用途。请参考类PDFNameTree 的注释以获取更多详细信息。如果未找到,此函数将返回null。

◆ GetType()

def FoxitPDFSDKPython3.PDFNameTree.GetType ( )

获取当前名称树的类型。

返回: 当前名称树的类型。请参考从FoxitPDFSDKPython3.PDFNameTree.e_Dests 开始的值, 这将是这些值中的一个。

◆ HasName()

def FoxitPDFSDKPython3.PDFNameTree.HasName ( name )

检查指定的键名是否存在于当前名称树中。

参数

[in] name 表示要检查的键名的字符串。它不应该是空字符串。

返回: true表示指定的名称存在于当前名称树中, false表示指定的名称不存在于当前名称树中。

◆ IsEmpty()

def FoxitPDFSDKPython3.PDFNameTree.IsEmpty ( )

检查当前对象是否为空。

当当前对象为空时,这意味着当前对象无用。

返回: true表示当前对象为空,而false表示不为空。

◆ RemoveAllObjs()

def FoxitPDFSDKPython3.PDFNameTree.RemoveAllObjs ( )

从当前名称树中删除所有键名及其值(作为PDF对象)。

返回: true表示成功,而false表示失败。

◆ RemoveObj()

def FoxitPDFSDKPython3.PDFNameTree.RemoveObj ( name )

从当前名称树中删除一个键名及其值(作为PDF对象)。

如果输入的名称在当前名称树中不存在,此函数将直接返回true。

参数

[in] name 要删除的键名的字符串。这不应该是空字符串。

返回: true表示成功,而false表示失败。

◆ Rename()

def FoxitPDFSDKPython3.PDFNameTree.Rename	(	old_name,
		new_name
	)

将现有键名重命名为新键名。

参数

[in]	old_name	要重命名的旧键名的字符串。这不应该是空字符串。此名称应该已存在于当前名称树中。
[in]	new_name	新键名的字符串。这不应该是空字符串。此新名称不应该已存在于当前名称树中。

返回: true表示成功,而false表示失败。

◆ SetObj()

def FoxitPDFSDKPython3.PDFNameTree.SetObj	(	name,
		pdf_object
	)

设置指定键名的值(作为PDF对象)。

参数

[in]	name	键名的字符串。它不应该是空字符串。此名称应该已存在于当前名称树中。
[in]	pdf_object	要设置为名称值的PDF对象。它不应该是null。此PDF对象的类型应该与当前名称树匹配;否则, 输入的PDF对象无效。请参考类PDFNameTree 的注释以获取更多详细信息。此函数成功后,用户不应释放此PDF对象。

返回: true表示成功,而false表示失败。

Public 成员函数

静态 Public 属性

详细描述

构造及析构函数说明

◆ PDFNameTree() [1/2]

◆ PDFNameTree() [2/2]

成员函数说明

◆ Add()

◆ GetCount()

◆ GetName()

◆ GetObj()

◆ GetType()

◆ HasName()

◆ IsEmpty()

◆ RemoveAllObjs()

◆ RemoveObj()

◆ Rename()

◆ SetObj()